SecureField#

The SecureField component in Scripting provides a secure, private text input field intended for entering sensitive information such as passwords. The entered text is visually obscured and not displayed in plain text, mirroring the behavior of SwiftUI’s SecureField.

This component is useful in authentication forms, PIN inputs, or any context where user privacy is essential.

#Props

type SecureFieldProps = (
  | { title: string }
  | { label: VirtualNode }
) & {
  value: string
  onChanged: (value: string) => void
  prompt?: string
  autofocus?: boolean
  onFocus?: () => void
  onBlur?: () => void
}

#Property Descriptions

#Example

import { useState, VStack, SecureField } from "scripting"

function LoginForm() {
  const [password, setPassword] = useState("")

  return <VStack padding>
    <SecureField
      title="Password"
      value={password}
      onChanged={setPassword}
      prompt="Enter your password"
    />
  </VStack>
}

In this example:

• A secure input field is used to capture a password.
• The input is visually hidden to ensure privacy.
• The prompt guides the user when no text is entered.

#Notes

• Either title or label must be provided (but not both).
• The field behaves similarly to TextField, with added security features for sensitive input.
• This component is suitable for use in login, signup, and settings forms where password entry is required.